{$INCLUDE}

The include directive instructs the compiler to insert source code from an external file at the position of the include directive statement. The syntax for an include directive is:

{$INCLUDE <file path>}

The path to the file containing VectorScript source code may be either a fully specified or partial file path. Macintosh style path delimiters ( : ), or Windows style path delimiters ( \ ) are supported. Windows style delimiters are recommended for scripts which may be used in a cross-platform environment to ensure compatibility on all platforms.

Example: Macintosh-style include directive

{$INCLUDE MyHD:VectorWorks:Projects:VS:mycode:math.vss}

Example: Windows-style include directive

{$INCLUDE MyHD\VectorWorks\Projects\VS\mycode\math.vss}

Include files specified without any path information are assumed to reside in a predefined default path relative to the script. For document scripts and scripts run from text files, the default path is the location of the VectorWorks application. For plug-ins, the default path is assumed to be the folder where the associated plug-in is located.

Include statements may also be chained by specifying include directives in other include files. Chaining include directives should be used with care, as it can cause file dependencies which may cause scripts to fail under certain circumstances.

Caution should also be exercised when positioning include directives in your scripts to avoid calling functions before they are defined within the script.